d払い(継続課金) ファイル送信仕様

d払い継続課金では、当サービスから加盟店様へ日次で課金ファイル、申込状況ファイルを送信します。
送信先は当サービスショップ管理画面の、メニュー「継続決済」>「docomo継続課金」>「設定」にて設定します。
それぞれのファイルは12:00までに加盟店様へ送信します。ただしメンテナンスや障害発生時には遅延する可能性があります。また、検証環境では12:00以降にファイルが送信されます。
加盟店様からの正常応答が確認できなかった場合は60秒ごとに5回再送します。

注意

結果通知プログラムにおいて、決済結果をhttps通信にて受け取る場合は、第三者が発行したSSLサーバ証明書が必要になります。
尚、弊社で動作保証をしている電子証明書は下記になります。
 ・ベリサイン
 ・GlobalSign
 ・日本ジオトラスト
※上記以外の電子証明書を使用する場合は、必ずテスト環境で疎通確認してください。

日次課金ファイル

対象データがある場合のみ、ファイル作成前日にドコモで処理された課金データの処理結果を日次でショップID単位に作成します。

ファイル出力対象

日次課金ファイルに出力される決済情報は以下の条件です。
・ファイル作成前日にドコモセンターで確定、変更、取消された課金データ

ファイル情報

日次課金ファイルは、ヘッダ、データ(課金データ件数分)、フッタの3種類のレコード構成となります。

出力パラメータ(当サービス⇒加盟店様)
fileContents 必須 ファイル
ファイル
日次課金ファイルを返却します。
※ファイルの文字コードはUTF-8となります。

■ファイル情報

ファイル名
"C_"+ショップID+"_"+処理日(yyyymmdd)+ランダムの数字※+".csv"
C_9999999999999_2022091663419.csv
※ランダムの数字:0~9223372036854775807の範囲
区切り文字
半角コンマ
改行コード
CRLF
ソート順
オーダID,課金月の昇順
囲み文字
ダブルクォート

■ヘッダレコード

レコード区分 必須 半角英字2桁
"HD"固定となります。
ショップID 必須 半角英数13桁
ショップIDを設定します。
データレコード件数 必須 半角数字8桁
データレコードの件数を設定します。

■データレコード

ショップID 必須 半角英数13桁
オーダーID 必須 半角英数記号27桁
課金月 必須 半角数字6桁
課金月をyyyyMM形式で返却します。
取引状態 必須 半角英字15桁
取引状態を返却します。
【SALES:課金済み】
【CANCEL:キャンセル】
【INVALID:無効】
利用金額 必須 半角数字6桁
税送料 必須 半角数字6桁
キャンセル金額 半角数字6桁
キャンセル税送料 半角数字6桁
取引ID 必須 半角英数32桁
取引パスワード 必須 半角英数32桁
ドコモ課金番号 必須 半角数字18桁
ドコモ加盟店注文番号 必須 半角数字20桁
処理期限 必須 半角数字14桁
処理期限をyyyyMMddHHmmss形式で返却します。
エラーコード 半角英数3桁
エラー詳細コード 半角英数9桁
処理日時 必須 半角数字14桁
処理日時をyyyyMMddHHmmss

■フッタレコード

レコード区分 必須 半角英字2桁
"FT"固定となります。

入力パラメータ(加盟店様⇒当サービス)
RecvRes 必須 半角数字1桁
受信結果
以下のいずれか
0:受信OK
1:受信失敗

申込状況ファイル

当月有効な継続課金申込みデータを日次でショップID単位に作成します。

ファイル出力対象

申込状況ファイルに出力される決済情報は以下の条件です。
・契約中の申込みデータ
・当月末で解約となる申込みデータ

ファイル情報

申込状況ファイルは、ヘッダ、データ(課金データ件数分)、フッタの3種類のレコード構成となります。

出力パラメータ(当サービス⇒加盟店様)
fileContents 必須 ファイル
ファイル
申込状況ファイルを返却します。
※ファイルの文字コードはUTF-8となります。

■ファイル情報

ファイル名
"R_"+ショップID+"_"+処理日(yyyymmdd)+ランダムの数字※+".csv"
R_9999999999999_2022091663419.csv
※ランダムの数字:0~9223372036854775807の範囲
区切り文字
半角コンマ
改行コード
CRLF
ソート順
オーダID,課金月の昇順
囲み文字
ダブルクォート

■ヘッダレコード

レコード区分 必須 半角英字2桁
"HD"固定となります。
ショップID 必須 半角英数13桁
ショップIDを設定します。
データレコード件数 必須 半角数字8桁
データレコードの件数を設定します。

■データレコード

ショップID 必須 半角英数13桁
オーダーID 必須 半角英数記号27桁
取引状態 必須 半角英字15桁
取引状態を返却します。
【REGISTER:契約中】
【RUN-CHANGE:変更処理中】
【RUN-END:契約終了処理中】
【END:契約終了】
利用金額 必須 半角数字6桁
税送料 必須 半角数字6桁
変更利用金額 半角数字6桁
変更税送料 半角数字6桁
ドコモ表示項目1 全半角40バイト
ドコモ表示項目2 全半角40バイト
ドコモ決済番号 必須 半角数字12桁
加盟店自由項目1 全半角100バイト
加盟店自由項目2 全半角100バイト
加盟店自由項目3 全半角100バイト
取引ID 必須 半角英数32桁
取引パスワード 必須 半角英数32桁
ドコモ加盟店注文番号 必須 半角数字20桁
ドコモ端末区分 必須 半角英字2桁
お客様の端末区分を返却します。
【SP:SPモード】
Wi-fiテザリング接続 必須 半角数字1桁
お客様のWi-fiテザリング接続状況を返却します。
【0:Wi-fiテザリング接続なし】
【1:Wi-fiテザリング接続有】
確定基準日 必須 半角数字2桁
初月無料フラグ 必須 半角数字1桁
初月無料フラグを返却します。
【0:初月有料】
【1:初月無料】
終了月無料フラグ 半角数字1桁
終了月無料フラグを返却します。
【0:終了月有料】
【1:終了月無料】
継続課金終了日 半角数字14桁
継続課金終了日をyyyyMMddHHmmss形式で返却します。
エラーコード 半角英数3桁
エラー詳細コード 半角英数9桁
処理日時 必須 半角数字14桁
処理日時をyyyyMMddHHmmss

■フッタレコード

レコード区分 必須 半角英字2桁
"FT"固定となります。

入力パラメータ(加盟店様⇒当サービス)
RecvRes 必須 半角数字1桁
受信結果
以下のいずれか
0:受信OK
1:受信失敗